Skip to content

Fix PR builds that are failing due to "broken links"#2142

Merged
dscho merged 1 commit intogit:gh-pagesfrom
dscho:fix-ci-errors
Mar 7, 2026
Merged

Fix PR builds that are failing due to "broken links"#2142
dscho merged 1 commit intogit:gh-pagesfrom
dscho:fix-ci-errors

Conversation

@dscho
Copy link
Member

@dscho dscho commented Mar 7, 2026

Changes

  • Fixes the PR builds after a silent update to lychee 0.23.0.

Context

Since February 28th, 2026, our PR builds are failing consistently (which I noticed only today):

image

The reason is not that all of a sudden, this project only receives crappy contributions. The reason is that a silent upgrade of lychee to 0.23.0 (which did not require a separate upgrade of the lychee GitHub Action, apparently) now makes the use of --root-dir mandatory when referring to absolute paths in, say, the .css files.

The symptom looks like this:

Summary

Status Count
🔍 Total 1708256
✅ Successful 1694831
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 13397
❓ Unknown 0
🚫 Errors 28
⛔ Unsupported 0

Errors per input

Errors in public/application.min.71f7939ea93a5a92743051d3cd11096ae5cec3a3c519720942f820ce92c1d41b.css

  • [ERROR] error: | Error building URL for "/images/bg/body.jpg" (Attribute: Some("url")): Cannot convert path '/images/bg/body.jpg' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/bg/body.jpg" (Attribute: Some("url")): Cannot convert path '/images/bg/body.jpg' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/bg/isometric-grid.png" (Attribute: Some("url")): Cannot convert path '/images/bg/isometric-grid.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/bg/isometric-grid.png" (Attribute: Some("url")): Cannot convert path '/images/bg/isometric-grid.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/bg/isometric-grid.png" (Attribute: Some("url")): Cannot convert path '/images/bg/isometric-grid.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/bg/search-header.jpg" (Attribute: Some("url")): Cannot convert path '/images/bg/search-header.jpg' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/admin-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/admin-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/book.png" (Attribute: Some("url")): Cannot convert path '/images/icons/book.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/branch-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/branch-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/camera-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/camera-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/debugging-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/debugging-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/document.png" (Attribute: Some("url")): Cannot convert path '/images/icons/document.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/document.png" (Attribute: Some("url")): Cannot convert path '/images/icons/document.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/download.png" (Attribute: Some("url")): Cannot convert path '/images/icons/download.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/email-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/email-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/external-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/external-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/info.png" (Attribute: Some("url")): Cannot convert path '/images/icons/info.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/inspection-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/inspection-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/patching-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/patching-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/plumbing-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/plumbing-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/projects-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/projects-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/search.png" (Attribute: Some("url")): Cannot convert path '/images/icons/search.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/server-admin-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/server-admin-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/setup-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/setup-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/sharing-sm.png" (Attribute: Some("url")): Cannot convert path '/images/icons/sharing-sm.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/icons/sidebar.png" (Attribute: Some("url")): Cannot convert path '/images/icons/sidebar.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/logos/downloads/Git-Icon-1788C.png" (Attribute: Some("url")): Cannot convert path '/images/logos/downloads/Git-Icon-1788C.png' to a URI: To resolve root-relative links in local files, provide a root dir
  • [ERROR] error: | Error building URL for "/images/sidebar-divider.png" (Attribute: Some("url")): Cannot convert path '/images/sidebar-divider.png' to a URI: To resolve root-relative links in local files, provide a root dir

Simply providing a --root-dir option fixes this.

These errors seem to have been with us since February 28th, 2026, which
was when lychee 0.23.0 was used for the PR build for the first time:
https://github.com/git/git-scm.com/actions/runs/22511224516/job/65220662173#step:15:70

  [...]

  ### Errors in public/application.min.85d33c919f3ff9788e84d1be0d991a68627af6191d5d6ce65ac9a1216a11e585.css

  Error: * [ERROR] <error:> | Error building URL for
    "/images/bg/body.jpg" (Attribute: Some("url")): Cannot convert path
    '/images/bg/body.jpg' to a URI: To resolve root-relative links in local
    files, provide a root dir
  Error: * [ERROR] <error:> | Error building URL for
    "/images/bg/body.jpg" (Attribute: Some("url")): Cannot convert path
    '/images/bg/body.jpg' to a URI: To resolve root-relative links in local
    files, provide a root dir
  Error: * [ERROR] <error:> | Error building URL for
    "/images/bg/isometric-grid.png" (Attribute: Some("url")): Cannot convert
    path '/images/bg/isometric-grid.png' to a URI: To resolve root-relative
    links in local files, provide a root dir
  [...]

The preceding PR build succeeded on February 23rd, 2026:
https://github.com/git/git-scm.com/actions/runs/22313554003/job/64551960417#step:15:70
(it used lychee 0.21.0, still).

There haven't been any announcements of breaking changes in the 0.22.0
nor in the 0.23.0 release notes that would talk about `--root-dir` being
required (https://github.com/lycheeverse/lychee/releases), but it is now
obviously required.

This only affected the PR builds because we already use the `--root-dir`
option in the deployment pipeline (to work around issues stemming from
absolute URL path prefixes being required in forks).

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
@dscho dscho self-assigned this Mar 7, 2026
@dscho dscho changed the title WIP Fix PR builds that are failing due to "broken links" Mar 7, 2026
@dscho dscho marked this pull request as ready for review March 7, 2026 10:38
@dscho dscho merged commit f5a8074 into git:gh-pages Mar 7, 2026
1 check passed
@dscho dscho deleted the fix-ci-errors branch March 7, 2026 10:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant